{{indexmenu_n>6}}

====== Marks and Routes ======

  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#marks|Marks]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#create_a_mark|Create a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#move_a_mark|Move a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#move_a_mark|Lock Unlock a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#delete_a_mark|Delete a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#undo-redo_a_mark|Undo-redo a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#right-click_on_a_mark|Right-Click on a Mark]]//
  * //[[:opencpn:opencpn_user_manual:getting_started:marks_and_routes#use_your_own_icons|Use your own Icons]]//
Located in Toolbar Buttons Pages

  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#create_route|Create Route]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#create_route_route_concepts|Route Concepts]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#create_a_route|Create a Route]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#create_route_create_route|Create Route]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#modify_a_route|Modify a Route]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#multiple_routes|Multiple Routes]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:route_mark_manager#export_route|Saving and Loading Routes and Marks]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#activating_routes_and_active_route_console|Activate Route & Active Route Console]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#active_route_console_window|Active Route Console Window]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#showing_active_leg_active_full_route_data|Active Leg and Full Route Data]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#route_to_autopilot|Route to Autopilot]]//
  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#route_to_autopilot|Route to Autopilot]]//
==== Marks Routes ====

{{:opencpn:manual:waypoint-active.png?nolink&40x37}}…{{:opencpn:manual:mark-triangle.png?nolink&37x36}}…{{:opencpn:manual:mark-shipwreck.png?nolink&40x36}}…{{:opencpn:manual:mob_btn.png?nolink&32x32}}…{{:opencpn:manual:route.png?nolink&32x32}} \\ Route Triangle Shipwreck MOB Create Route

First right-click on the chart and pick "Drop Mark"

{{:opencpn:manual:mark-create.png?nolink&300x284}}

Then right click nearby and select "Undo Create Waypoint"

{{:opencpn:manual:mark-undo-create-waypoint.png?nolink&300x272}}

Or right-click on the Mark and select "Delete"

{{:opencpn:manual:waypoint-delete.png?nolink&300x233}}

==== Marks ====

Are the basic points that are used for many things, such as creating routes, marking fishing spots, good anchorages or anything of interest.

Once a mark is created a focused **right-click dialog**  becomes available, when clicking on the mark.

{{:opencpn:manual:wpt_focus2.png?nolink&306x193}}

=== Create a mark ===

There are a few ways to directly create marks.

  * at boat's position "Ctrl + O".
  * at cursor position "Ctrl + M".
  * at cursor position "Right-click" & press "Drop Mark".

Marks are created at the start of each leg in a route, and one at the end of the route. More about routes a bit further down this page.

Marks created these ways will have a triangular icon, except for routes that uses a diamond, but no name.

The default icon, when creating a mark, is possible by changing the the value **"DefaultWPIcon"**  in the **opencpn.ini**  (config) file. Use the name of any available icon in the properties dialog.

More Detail In the **[Settings/Others]**  section set the option **DefaultWPIcon **to one of:

empty, airplane, anchorage, anchor, boarding, boundary, bouy1, bouy2, campfire, camping, coral, fishhaven, fishing, fish, floating, food, fuel, greenlite, kelp, light, light1, litevessel, mooring, oilbouy, platform, redgreenlite, redlite, rock1, rock2, sand, scuba, shoal, snag, square, triangle, diamond, circle, wreck1, wreck2, xmblue, xmblue_, xmgreen, xmgreen_, xmred, xmred_, activepoint

values representing the default set of built-in icons or to a filename of any of your UserIcons, without the the path and .xpm extension. If you have a file called **MyICON.xpm**  in the //user icons folder//, the value will be simply **MyICON**

=== Move a Mark ===

and **Lock Unlock**

  - You can **move **the mark by left-click-dragging it around. (Program has changed? -Removed?)
  - To prevent accidental movement of marks go to [[:opencpn:opencpn_user_manual:options_setting:ships#routes_-_points|Options > Ships > Routes/Points > Control Options]] (v4.8.8 menu: Options>Display>Advanced) and click the box "**Lock Waypoints**".
  - Another alternative to move a single mark or waypoint is to right click on it, select properties and move the mark. Then close properties to lock the mark.

{{:opencpn:manual:lockwpt.png?nolink&471x45}}

=== Delete a Mark ===

You can **delete**  a mark by right-clicking its icon, and selecting "Delete".

=== Undo-Redo a Mark ===

There is an built in **undo/redo **buffer for creating, deleting or moving marks or waypoints. If you have just created, deleted or moved a mark the right-click dialog will have relevant entries. The undo/redo, for moving or creating marks, follows a straight time-line and is not tied to an individual mark.

{{:opencpn:manual:rc_wpt-del-mv.png?nolink&288x360}}

=== Right-click on a Mark ===

Above is a right-click menu just after moving a mark a few times and undoing the last move, and one mark was deleted, and then the deletion was undone. CTRL + Z and CTRL + Y works as hot-keys for undo/redo.

=== Mark Properties ===

All marks have properties that can be seen by right-clicking and pressing "Properties", or even simpler just double click the mark.

{{:opencpn:manual:waypoint-rings.png?nolink&471x394}}

**Read about the Properties Dialog in**  **//[[:opencpn:opencpn_user_manual:advanced_features:extended_marks|Advanced Features > Extended ]]//** **//[[:opencpn:opencpn_user_manual:advanced_features:extended_marks|Marks]]// **
  - Marks can be manipulated through the Route & Mark Managers Waypoints tab as well.
  - Deleting a mark that is part of a route, will also change the route.
  - Marks that are a part of a "layer" cannot be changed at all.
  - Marks can also be imported into OpenCPN in a number of ways.
  - Hidden waypoints are not offered as "Use nearby WPT" while creating a route.

Also read **//[[:opencpn:opencpn_user_manual:toolbar_buttons:route_mark_manager|]] //** Global locking of all marks is available. **[[:opencpn:opencpn_user_manual:options_setting:ships#routes_-_points|Options → Ships → Own Ship → Routes-Points → Control Options]] **and tick the box. This feature prevents accidentally moving a mark. Activate this feature when underway, deactivate it when planning.

{{:opencpn:manual:lockwpt.png?nolink&471x45}}

The **//[[:opencpn:opencpn_user_manual:toolbar_buttons:man_overboard|Man ]]//** **//[[:opencpn:opencpn_user_manual:toolbar_buttons:man_overboard|OverBoard ]]//** mark can be activated through the icon {{:opencpn:manual:mob_btn.png?nolink&32x32}}in the toolbar, or through hitting Ctrl + Space-bar. The mark looks like the button and is dropped on own boats present gps position. This mark cannot be moved or deleted with the cursor or keyboard (by mistake), but can still be deleted from the Route/Waypoint manager dialog. More about **//[[:opencpn:opencpn_user_manual:toolbar_buttons:man_overboard|Man ]]//** **//[[:opencpn:opencpn_user_manual:toolbar_buttons:man_overboard|OverBoard ]]//** here. \\  \\ All the details of the Mark/WP Properties dialog are dealt with in **//[[:opencpn:opencpn_user_manual:advanced_features:extended_marks|]]// **

==== Use your own Icons ====

OpenCPN comes with a handful of different icons that can be assigned to a mark. Right click or use the Route Manager and activate the properties dialog. The Mark Icon window in the dialog shows the available icons. \\  \\ A user can install his or her own icons to use with marks and "own ship". \\  \\ 1. Create a directory called "UserIcons" in the same place that holds your opencpn.ini(config) file. Instructions to find the directory (folder) location here: **//[[:opencpn:opencpn_user_manual:getting_started:opencpn_installation|]]// ** \\  \\ 2. Add .png image files to this directory. The legacy .xpm format works as well. The icons can be any size. The name of the file (without the extension) becomes the name of the new waypoint icon. These new icons will appear on the Waypoint Properties dialog, and can be assigned to any waypoint. They can also be assigned in GPX Import files. \\  \\ 3. The **//[[:opencpn:opencpn_user_manual:advanced_features:user_icons|User ]]//** **//[[:opencpn:opencpn_user_manual:advanced_features:user_icons|Icons]]//** page contains links to a few sets of user contributed icons. \\  \\ 4.To replace the default own ship icon {{:opencpn:manual:ship_red.png?nolink&19x45}}, just put a file "ownship.png" or "ownship.xpm", containing the ownship picture you prefer, in the UserIcons directory, described above. \\ More about "ownship" icons and setting "ownship" size in **//[[https://opencpn.org/wiki/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:options_setting:ships#own_ship|Options Setting - Own Ship]].// **

==== Read about Creating Routes in Create Route ====

Located in Toolbar Button Pages

  * //[[:opencpn:opencpn_user_manual:toolbar_buttons:create_route#create_route|Create Route]]//
==== Technical: Routes, Waypoints, Navobjects, Gpx and Guid ====

  * Waypoint is a waypoint ("wpt" entity in the GPX file).
  * Route point ("rtept" entity in the GPX file) may, but does not have to, also be a waypoint.
  * All the navobjects with the exception of track points ("trkpt" entity in the GPX file) do have a "GUID" in GPX produced by OpenCPN.
  * The "GUID" is the primary identifier used to see if the object already exists or not (with the exception of "wpt" import, see below).
  * Two objects with the same "GUID" can not exist at the same time.
  * A waypoint may also be included in zero to many routes.
  * A route point may not exist without a route though (= must be included in 1 to many existing routes and unlike a waypoint, it is also for example deleted with the last route it is a part of).
  * It is not possible to have the same waypoint in a layer and then import it from a GPX file.
  * The logic used for "wpt" entities during the import to determine duplicates is the "Name" and "lat" + "lon", (because we can not rely on the imported entity having the OpenCPN specific GUID extension during the import).
  * The "GUID" represents the internal globally **//unique//**  identifier of the navobject in OpenCPN and is completely irrelevant in the waypoint import from GPX as you can see above (It is used elsewhere for other purposes).
  * Import of a Route Gpx File with duplicate waypoints will result in a message, and the existing waypoint will be shared.

{{:opencpn:manual:gpx-import-duplicate-wpt-notice.png?400|gpx-import-duplicate-wpt-notice}}

==== IN LINUX: Be aware of the proper settings for the decimal separator when running certain versions of OpenCPN 5.2 ====

When running certain versions of OpenCPN 5.2 on a Linux system, your Routes, Tracks and Waypoints might get corrupted if your "locale" settings in Linux are for a country that uses a comma (",") as a decimal separator.

A "locale" is a set of environmental variables in Linux that defines things such as the time/date format, the first day of the week, currency, numbers and many other values formatted in accordance with the language or region/country you set on a Linux system. In some countries a comma (",") is used as a decimal separator. This also affects the way the coördinates of your Routes, Tracks and Waypoints are stored in navobj.xml.

OpenCPN uses a dot (".") as a decimal separator. At the next start of the program, OpenCPN fails to translate the comma's into dots, which corrupts the coördinates of Routes, Tracks and Waypoints stored in navobj.xml.

The same bug can cause OpenCPN to show the world map at each startup (fully zoomed out instead of the latest map and zoom level).

This problem seems to have been solved in version Version 5.2.4 Build 2020-10-14.

See also [[:opencpn:opencpn_user_manual:faq#routes_tracks_and_waypoints_get_corrupted_in_linux|this]] section in the FAQ.

